LEGION Model Builder Help

Creating an Entity Type

We recommend that you create your Entity Types in the LEGION Data Template (see Entities worksheet), but you can create them manually in LEGION Model Builder as described here.

To create an Entity Type:

  1. Click or select Data > Entity Types.
    • The ‘Edit Entity Type’ dialog box is displayed.
    • The left-hand pane of the dialog box already contains a Default Entity Type, based on parameters associated with UK commuters. You could use this type for your model or proceed to create your own.
  2. Click the New button in the top left-hand corner.
  3. Enter a meaningful name for the Entity Type in the highlighted box and press Enter.
  4. On the Appearance tab select a colour for the Entity Type from the Colour drop-down list.
  5. For the Gender Ratio, leave at 50/50 or enter new percentages for 'Males' and 'Females' if required.
  6. For Entity Sizes, select one of the following:
    • System defined
    • Size profiles – if you select this option, choose a Size Profile from the drop-down lists labelled Male and Female (you may need to create these profiles; see Creating an Entity Size Profile.
  7. Select the Luggage Size option that matches your Entity Type:
    • No luggage
    • System random (automatic allocation of none, or small, medium, large ranges)
    • Size Profile (select a profile from the drop-down list; you may need to create one or more profiles–see Creating a Luggage Size Profile).
  8. Click on the Profile tab of the ‘Edit Entity Type’ dialog box.
  9. Select an Entity Profile from the drop-down list.
    • The different Entity Profiles are:
      • Asian
      • Chinese
      • North American
      • Southern European
      • UK (this is the default setting)
    • To apply a user-defined Speed Profile rather than a system profile, see Creating a User-defined Speed Profile, otherwise continue to the next step.
  10. Choose a Speed Profile from the Speed Profile drop-down menu.
    • Depending on the Entity Profile, the Speed Profile options are:
      • Asian
        • Asian Commuters
        • Asian Weekend Passengers
        • Runners
        • Stadium Users
        • Tourists
      • Chinese
        • Chinese Commuters
        • Chinese Weekend Passengers
        • Runners
        • Stadium Users
        • Tourists
      • North American
        • North American Commuters
        • Runners
        • Stadium Users
        • Tourists
      • Southern European
        • Runners
        • Southern European Commuters
        • Stadium Users
        • Tourists
      • UK
        • Central London Weekday *
        • Central London Weekday (Off-Peak)
        • Central London Weekday (Peak)
        • Central London Weekend * *
        • Central London Weekend (Daytime)
        • Central London Weekend (Evening)
        • Runners
        • Stadium Users
        • Tourists
        • UK Commuters
          Warning: Use the Runners speed profile with care. It represents people running when leaving a stadium. We recommend that you use this exclusively for modelling stadia and then only for a small number of Entities, e.g. 25% of the first 5% of people leaving a stadium.
    * Combines Peak and Off-peak data
    **Combines Daytime and Evening data
  11. Click Apply or OK to save the new Entity Type. It is added to the ‘Data’ tab of LEGION Model Builder Object Directory, under Entity Type.

A Note on Speed Profiles

An Entity’s preferred speed is rarely its actual speed within a simulation. The latter is a function of crowding, geometry, and context. It would be a mistake to try to ‘program’ an Entity to walk at a certain speed.

Tip: User-defined Speed Profiles can be created using either the Data Template spreadsheet (see Entities worksheet) or the Edit Data Profiles dialog (see Creating a User-defined Speed Profile).